<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkText</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkProgress.html" title="GtkProgress">
<link rel="next" href="GtkTooltips.html" title="GtkTooltips">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkProgress.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
<td><a accesskey="n" href="GtkTooltips.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkText.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#GtkText.description" class="shortcut">Description</a>
                   | 
                  <a href="#GtkText.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#GtkText.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                   | 
                  <a href="#GtkText.properties" class="shortcut">Properties</a>
                   | 
                  <a href="#GtkText.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry">
<a name="GtkText"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkText.top_of_page"></a>GtkText</span></h2>
<p>GtkText — A text widget</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkText.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="GtkText.html#GtkText-struct" title="struct GtkText">GtkText</a>;
                    <a class="link" href="GtkText.html#GtkTextFont" title="GtkTextFont">GtkTextFont</a>;
struct              <a class="link" href="GtkText.html#GtkPropertyMark" title="struct GtkPropertyMark">GtkPropertyMark</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkText.html#gtk-text-new" title="gtk_text_new ()">gtk_text_new</a>                        (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadj</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadj</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-set-editable" title="gtk_text_set_editable ()">gtk_text_set_editable</a>               (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> editable</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-set-word-wrap" title="gtk_text_set_word_wrap ()">gtk_text_set_word_wrap</a>              (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> word_wrap</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-set-line-wrap" title="gtk_text_set_line_wrap ()">gtk_text_set_line_wrap</a>              (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> line_wrap</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-set-adjustments" title="gtk_text_set_adjustments ()">gtk_text_set_adjustments</a>            (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadj</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadj</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-set-point" title="gtk_text_set_point ()">gtk_text_set_point</a>                  (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkText.html#gtk-text-get-point" title="gtk_text_get_point ()">gtk_text_get_point</a>                  (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkText.html#gtk-text-get-length" title="gtk_text_get_length ()">gtk_text_get_length</a>                 (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-freeze" title="gtk_text_freeze ()">gtk_text_freeze</a>                     (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-thaw" title="gtk_text_thaw ()">gtk_text_thaw</a>                       (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkText.html#gtk-text-insert" title="gtk_text_insert ()">gtk_text_insert</a>                     (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="../gdk/gdk-Fonts.html#GdkFont"><span class="type">GdkFont</span></a> *font</code></em>,
                                                         <em class="parameter"><code>const <a href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *fore</code></em>,
                                                         <em class="parameter"><code>const <a href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *back</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *chars</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkText.html#gtk-text-backward-delete" title="gtk_text_backward_delete ()">gtk_text_backward_delete</a>            (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> nchars</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkText.html#gtk-text-forward-delete" title="gtk_text_forward_delete ()">gtk_text_forward_delete</a>             (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> nchars</code></em>);
#define             <a class="link" href="GtkText.html#GTK-TEXT-INDEX:CAPS" title="GTK_TEXT_INDEX()">GTK_TEXT_INDEX</a>                      (t,
                                                         index)
</pre>
</div>
<div class="refsect1">
<a name="GtkText.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkOldEditable.html" title="GtkOldEditable">GtkOldEditable</a>
                           +----GtkText
</pre>
</div>
<div class="refsect1">
<a name="GtkText.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkText implements
 AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and  <a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkText.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkText.html#GtkText--hadjustment" title='The "hadjustment" property'>hadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write
  "<a class="link" href="GtkText.html#GtkText--line-wrap" title='The "line-wrap" property'>line-wrap</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkText.html#GtkText--vadjustment" title='The "vadjustment" property'>vadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write
  "<a class="link" href="GtkText.html#GtkText--word-wrap" title='The "word-wrap" property'>word-wrap</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkText.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkText.html#GtkText-set-scroll-adjustments" title='The "set-scroll-adjustments" signal'>set-scroll-adjustments</a>"                         : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
</pre>
</div>
<div class="refsect1">
<a name="GtkText.description"></a><h2>Description</h2>
<p>
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>
<a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol <code class="literal">GTK_ENABLE_BROKEN</code>
prior to including the GTK+ header files. Use <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> instead.
</p>
</div>
<p>
A <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget allows one to display any given text and manipulate it
by deleting from one point to another, selecting a region, and various
other functions as outlined below.  It is inherited from <a class="link" href="GtkEditable.html" title="GtkEditable"><span class="type">GtkEditable</span></a>.
</p>
</div>
<div class="refsect1">
<a name="GtkText.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkText-struct"></a><h3>struct GtkText</h3>
<pre class="programlisting">struct GtkText;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkText</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Most of the <a class="link" href="GtkText.html#GtkText-struct" title="struct GtkText"><span class="type">GtkText</span></a> struct members should not be accessed directly.
Listed below are a few exceptions and how to use them.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTextFont"></a><h3>GtkTextFont</h3>
<pre class="programlisting">typedef struct _GtkTextFont GtkTextFont;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkTextFont</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Internal <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> data type.

</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkPropertyMark"></a><h3>struct GtkPropertyMark</h3>
<pre class="programlisting">struct GtkPropertyMark {
  /* Position in list. */
  GList* property;

  /* Offset into that property. */
  guint offset;

  /* Current index. */
  guint index;
};
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPropertyMark</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Internal <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> data type.  Should not be accessed directly.

</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-new"></a><h3>gtk_text_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_text_new                        (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadj</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadj</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget, initialized with the given pointers to
<a href="GtkAdjustment.html"><span class="type">GtkAdjustments</span></a>.  These pointers can be used to track the viewing position
of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.  Passing <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to either or both of them will make
the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> create its own.  You can set these later with the function
<code class="function">gtk_text_set_adjustment()</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hadj</code></em> :</span></p></td>
<td>horizontal adjustment.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>vadj</code></em> :</span></p></td>
<td>vertical adjustment.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-set-editable"></a><h3>gtk_text_set_editable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_set_editable               (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> editable</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_editable</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget can be edited by the user or not.  This
still allows you the programmer to make changes with the various <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>
functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>editable</code></em> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> makes it editable, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> makes it immutable by the user</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-set-word-wrap"></a><h3>gtk_text_set_word_wrap ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_set_word_wrap              (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> word_wrap</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_word_wrap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget wraps words down to the next line if it
can't be completed on the current line.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>word_wrap</code></em> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> makes it word wrap, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> disables word wrapping</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-set-line-wrap"></a><h3>gtk_text_set_line_wrap ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_set_line_wrap              (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> line_wrap</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_line_wrap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Controls how <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> handles long lines of continuous text.  If line wrap
is on, the line is broken when it reaches the extent of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
viewing area and the rest is displayed on the next line.  If it is not set,
the line continues regardless size of current viewing area.  Similar to word
wrap but it disregards word boundaries.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>line_wrap</code></em> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> turns line wrap on, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> turns it off</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-set-adjustments"></a><h3>gtk_text_set_adjustments ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_set_adjustments            (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *hadj</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *vadj</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_adjustments</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Allows you to set <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> pointers which in turn allows you to
keep track of the viewing position of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>hadj</code></em> :</span></p></td>
<td>the horizontal adjustment</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>vadj</code></em> :</span></p></td>
<td>the vertical adjustment</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-set-point"></a><h3>gtk_text_set_point ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_set_point                  (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_point</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the cursor at the given point.  In this case a point constitutes
the number of characters from the extreme upper left corner of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>
widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
<td>the number of characters from the upper left corner</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-get-point"></a><h3>gtk_text_get_point ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_text_get_point                  (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_get_point</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Gets the current position of the cursor as the number of characters from
the upper left corner of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the number of characters from the upper left corner</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-get-length"></a><h3>gtk_text_get_length ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_text_get_length                 (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_get_length</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the length of the all the text contained within the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget;
disregards current point position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the length of the text</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-freeze"></a><h3>gtk_text_freeze ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_freeze                     (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_freeze</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Freezes the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget which disallows redrawing of the widget until
it is thawed.  This is useful if a large number of changes are going to
made to the text within the widget, reducing the amount of flicker seen
by the user.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-thaw"></a><h3>gtk_text_thaw ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_thaw                       (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_thaw</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Allows the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to be redrawn again by GTK.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-insert"></a><h3>gtk_text_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_text_insert                     (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="../gdk/gdk-Fonts.html#GdkFont"><span class="type">GdkFont</span></a> *font</code></em>,
                                                         <em class="parameter"><code>const <a href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *fore</code></em>,
                                                         <em class="parameter"><code>const <a href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *back</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *chars</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_insert</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts given text into the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget with the given properties as
outlined below.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
<td>the <a href="../gdk/gdk-Fonts.html#GdkFont"><span class="type">GdkFont</span></a> to use</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>fore</code></em> :</span></p></td>
<td>the foreground color to insert with</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>back</code></em> :</span></p></td>
<td>the background color to insert with</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>chars</code></em> :</span></p></td>
<td>the actual text to be inserted</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>the length of the text to be inserted, passing -1 makes it insert
all the text.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-backward-delete"></a><h3>gtk_text_backward_delete ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_text_backward_delete            (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> nchars</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_backward_delete</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deletes from the current point position backward the given number of
characters.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>nchars</code></em> :</span></p></td>
<td>the number of characters to delete</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-text-forward-delete"></a><h3>gtk_text_forward_delete ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_text_forward_delete             (<em class="parameter"><code><a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> nchars</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_forward_delete</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deletes from the current point position forward the given number of
characters.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>nchars</code></em> :</span></p></td>
<td>the number of characters to delete</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GTK-TEXT-INDEX:CAPS"></a><h3>GTK_TEXT_INDEX()</h3>
<pre class="programlisting">#define             GTK_TEXT_INDEX(t, index)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GTK_TEXT_INDEX</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the character at the given index within the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>t</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
<td>the number of characters from the upper left corner</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkText.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkText--hadjustment"></a><h3>The <code class="literal">"hadjustment"</code> property</h3>
<pre class="programlisting">  "hadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write</pre>
<p>
Used by the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to keep track of the size of its horizontal
text.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkText--line-wrap"></a><h3>The <code class="literal">"line-wrap"</code> property</h3>
<pre class="programlisting">  "line-wrap"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>
Boolean value indicating whether line wrap is enabled or not.
</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkText--vadjustment"></a><h3>The <code class="literal">"vadjustment"</code> property</h3>
<pre class="programlisting">  "vadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write</pre>
<p>
Used by the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to keep track of the size of its vertical
text.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkText--word-wrap"></a><h3>The <code class="literal">"word-wrap"</code> property</h3>
<pre class="programlisting">  "word-wrap"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>
Boolean value indicated whether word wrap is enabled or not.
</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1">
<a name="GtkText.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkText-set-scroll-adjustments"></a><h3>The <code class="literal">"set-scroll-adjustments"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>       *text,
                                                        <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *arg1,
                                                        <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *arg2,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the object which received the signal.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>